home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / tools / czesc_2 / lacepointer / lacepointer.doc < prev    next >
Text File  |  1992-02-02  |  8KB  |  199 lines
  1.  
  2.  
  3.                           LacePointer 1.0 User Manual
  4.  
  5.                                  Feb 2, 1992
  6.  
  7.  
  8.  
  9. Preface
  10. =======
  11.  
  12.    The programs and files in this distribution are freely distributable, but
  13. are also copyright (c) Nico François.  They may be freely distributed as long
  14. as no more than a nominal fee is charged to cover time and copying costs.
  15.    No commercial usage is permitted without written permission from the
  16. author.  Everything in this distribution must be kept together, in original
  17. unmodified form.
  18.    The above is generally known as freeware.
  19.  
  20.    If you have suggestions or remarks about this program, or if you find
  21. any bugs, please let me know.
  22.  
  23.    Write to the following address:
  24.  
  25.                                 Nico François
  26.                                 Corbielaan 13
  27.                                 B-3060 Bertem
  28.                                 BELGIUM
  29.  
  30.  
  31. Contents
  32. ========
  33.  
  34. 1. An introduction
  35.  
  36. 2. Shell usage
  37.  
  38. 3. Workbench usage
  39.  
  40. 4. Compatibility
  41.  
  42.  
  43. 1. An introduction
  44. ==================
  45.  
  46.      When you first show the Amiga to someone have you ever heard this remark:
  47. "Gee, what a fantastic machine, but what's this enormous mouse pointer!" ?
  48. Then you can start explaining the mouse pointer is a hardware sprite and that
  49. these are always displayed in a Lores resolution.
  50.  
  51.      LacePointer is a program that will change all that.  Running LacePointer
  52. will _double_ the resolution of your mouse pointer.  So your pointer will be
  53. displayed in Lores-Interlace!
  54.  
  55.      LacePointer is based on a very simple but brilliant idea: if the Amiga
  56. interlaces bitplanes, why not interlace the mouse pointer as well ?
  57. LacePointer will display a different mouse pointer each frame.  Together these
  58. two pointers form a complete interlaced pointer.  The idea is not mine and all
  59. credit for it must go to Geert Uytterhoeven.
  60.  
  61.      One caveat becomes apparent: your screen must be interlaced!  So if you
  62. run LacePointer it will force interlace on all screens, or it will only take
  63. effect on interlaced screens (behaviour can be set using options).  Owners of
  64. an Amiga with some kind of flickerfixer (like an A3000 or an A2000 with A2320)
  65. naturally won't notice anything.
  66.  
  67.      Furthermore LacePointer will recognize the standard Workbench mouse
  68. pointer (1.3 and 2.0) and the standard 2.0 wait pointer.  It will replace
  69. these pointers with its own pointers which have been redesigned for Lores-
  70. Interlace.  The standard 2.0 wait pointer will be replaced with an animated
  71. pointer (the hand on the clock will turn).  All this can be turned off if you
  72. don't like it, but who wouldn't :-)
  73.  
  74.      Install LacePointer by putting it in your user-startup (on 2.0) or your
  75. startup-sequence (on 1.3), or by dragging it to your WbStartup drawer.  There
  76. is no need to 'Run' LacePointer.  It will install itself and exit immediately.
  77.  
  78.      LacePointer is provided in two versions.  One for Workbench 2.0 or higher
  79. (LacePointer) and one for Workbench 1.2/1.3 (LacePointer13).  LacePointer for
  80. Workbench 2.0 is shorter and more efficient than LacePointer13.  Apart from
  81. this the only difference between LacePointer13 and LacePointer is that
  82. LacePointer13 also recognizes (and replaces) the Workbench 1.3 Zzz cloud.
  83.  
  84.      LacePointer will take only 3K of memory once installed.  Overhead is
  85. reduced to a minimum thanks to an interrupt handler written entirely in high
  86. speed optimized 68000 assembly.
  87.  
  88.      LacePointer is compatible with and supports Kickstart & Workbench 2.0.
  89.  
  90.  
  91. 2. Shell usage
  92. ==============
  93.  
  94.      Enter 'LacePointer ?' for a usage template:
  95.  
  96.        LacePointer [NODEFPOINTER] [NOWAITPOINTER] [NOFORCELACE]
  97.                    [NOCLOCKTICK] [TICKSPEED n]
  98.  
  99.      Explanation of the options:
  100.  
  101.        NODEFPOINTER  : Do not replace the standard 1.3 or 2.0 mouse pointer
  102.                        with built-in Lores-Interlace replacement.
  103.  
  104.        NOWAITPOINTER : Do not replace the standard 2.0 wait pointer with
  105.                        built-in (animated) replacement.
  106.  
  107.        NOFORCELACE   : Do not force interlace on non-interlaced screens, but
  108.                        instead display the normal mouse pointer.
  109.  
  110.        NOCLOCKTICK   : Do not animate the Lores-Interlace wait pointer.
  111.  
  112.        TICKSPEED n   : Set the speed (in vertical blanks) with which the hand
  113.                        of the animated clock will turn.  Default 7, higher is
  114.                        slower.
  115.  
  116.      Running LacePointer again will remove it from memory.
  117.  
  118.  
  119. 3. Workbench usage
  120. ==================
  121.  
  122.      Double-click LacePointer to install it.  Double-click again to remove it
  123. from memory.  Options can be set in the icon's tooltypes.
  124.  
  125.      Select LacePointer's icon and choose 'Information' from the 'Icons' menu
  126. (Workbench 2.0) or 'Info' from the 'Workbench' menu (Workbench 1.3).  You can
  127. now edit LacePointer's tooltypes, check your manual for more information.
  128.  
  129.      Recognized tooltypes:
  130.  
  131.        NODEFPOINTER  : See Shell option.
  132.        NOWAITPOINTER :  "    "     "
  133.        NOFORCELACE   :  "    "     "
  134.        NOCLOCKTICK   :  "    "     "
  135.        TICKSPEED=n   :  "    "     "
  136.        QUIET         : Quiet startup.  Do not open a small window instructing
  137.                        LacePointer has been installed.
  138.  
  139.      Set the QUIET tooltype if you drag LacePointer to your WbStartup drawer.
  140. Otherwise you will be bothered with a window popping up everytime you boot.
  141. It is also best to enter STARTPRI=127 in the tooltypes so LacePointer will be
  142. executed before other programs in your WbStartup drawer.
  143.  
  144.  
  145. 4. Compatibility
  146. ================
  147.  
  148.      Quite a bit of work has gone into making LacePointer as compatible as
  149. possible with Intuition.  Present compatibility seems to be 100%.
  150.  
  151.      LacePointer is not a 100% legal program, simply because it can't be.
  152. There is (as far as I know) no legal way to replace the mouse pointer.
  153. Everything that could be done in a legal, future compatible way has been done
  154. so.  LacePointer should be as compatible with future versions of the Amiga
  155. operating system as it can be.
  156.  
  157.      LacePointer relies on the fact that Intuition uses the hardware sprite 0
  158. for its mouse pointer.  It gets this sprite from GfxBase->SimpleSprites[0].
  159. If either of these two facts change LacePointer will no longer function.  On
  160. the other hand, if these facts do change it will probably be because Intuition
  161. uses an improved mouse pointer so there will be no more use for LacePointer.
  162.  
  163.      LacePointer will almost certainly NOT work with the A2024 hires monitor!
  164.  
  165.      When running Kickstart 2.0 LacePointer will recognize Productivity mode
  166. screens.  It will not force interlace and lace the mouse pointer in this case.
  167. LacePointer is also compatible with SuperHires.
  168.  
  169.      I have been running beta versions of LacePointer for a few weeks now and
  170. I have encountered no problems.  If you have compatibility problems with
  171. LacePointer let me know and I'll try to fix what I can fix for the next
  172. version.
  173.  
  174.                            As always, I hope you find this program useful!
  175.  
  176.  
  177.                               PROGRAM HISTORY:
  178.  
  179. *****************************************************************************
  180. VERSION 1.0
  181.  
  182.      First release.
  183.  
  184. *****************************************************************************
  185.  
  186. LacePointer 1.0 written by Nico François (Yes, Nico is my first name :-)
  187.                 Special thanks to Jorrit Tyberghein and Geert Uytterhoeven
  188.  
  189.  
  190. "And when the planet hit the sun
  191.  I saw the face of Allison"      - Pixies
  192.  
  193.  
  194. (c) 1992 Nico François
  195.  
  196.                                    //
  197.                        Thanks to \X/ Amiga for being the best computer ever !
  198.  
  199.